home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2010 April / PCWorld0410.iso / hity wydania / Ubuntu 9.10 PL / karmelkowy-koliberek-desktop-9.10-i386-PL.iso / casper / filesystem.squashfs / usr / share / doc / gimp / README.MIDI < prev    next >
Encoding:
Text File  |  2009-08-31  |  3.0 KB  |  79 lines
  1. ----------------------------------------------------------------------
  2. Controlling GIMP with MIDI devices
  3. How To ┬⌐ 2005 Simon Budig. Licensed under the terms of the GNU GPL.
  4.  
  5. Retrieved from <http://www.gimp.org/unix/howtos/gimp-midi.html>
  6. by Ari Pollak <ari@debian.org> on 6 Apr 2005.
  7. ----------------------------------------------------------------------
  8.  
  9. What?
  10. -----
  11.  
  12. GIMP 2.2 comes with a module that allows to control it using MIDI devices.
  13. Currently this is only supported on Linux with either the OSS or the ALSA sound
  14. drivers. It might work on other platforms as well if there is a way to access
  15. the raw MIDI stream by opening a device.
  16.  
  17.  
  18. Enabling the MIDI Module
  19. ------------------------
  20.  
  21. To make the UI of Gimp's MIDI controller visible you need to edit a
  22. configuration file when the Gimp is not running. Open ~/.gimp-2.2/controllerrc
  23. in an editor and add the following lines to the end of the file:
  24.  
  25. (GimpControllerInfo "MIDI"
  26.     (enabled yes)
  27.     (debug-events yes)
  28.     (controller "ControllerMidi"
  29.         (device "alsa")
  30.         (channel -1))
  31.     (mapping))
  32.  
  33. Then start the GIMP from a shell (so that you can see textual output we need
  34. later), open the preferences, go to the "Input Controllers" page in the "Input
  35. Devices" section and select the newly appeared "MIDI" Tab.
  36.  
  37.  
  38. Configuring the MIDI Source
  39. ---------------------------
  40.  
  41. ALSA:
  42. Enter "alsa" in the "Device" entry in the configuration. Gimp then sets up an
  43. Alsa-Output-Port (check with "aconnect -lo"). You can then use your preferred
  44. tool to configure Alsa to connect a MIDI source to the GIMP. When your MIDI
  45. device e.g. provides an Input-Port 72:0 and Gimp provides the Output-Port 128:0
  46. you can connect the two Ports with "aconnect 72:0 128:0".
  47.  
  48. OSS:
  49. The Open Sound System provides a device file for the raw MIDI events. You need
  50. to enter the name of this device file into the "Device" entry in the
  51. configuration (e.g. "/dev/midi00").
  52.  
  53. The MIDI channel:
  54. Each MIDI source sends events on a specific "Channel" (0 to 15, sometimes also
  55. referred as 1 to 16). You can configure if Gimp should listen to all channels
  56. (-1) or to just a specific channel.
  57.  
  58. If your MIDI setup works correctly and the "Dump events from this controller"
  59. is enabled as well as "Enable this controller" you should see some text
  60. scrolling by when you hit some keys or turn some controllers on your midi
  61. device, describing the Event that just happened.
  62.  
  63.  
  64. Assigning Actions to Events
  65. ---------------------------
  66.  
  67. You can now use this information to map MIDI Events to Actions in the Gimp. At
  68. the bottom of the configuration page is a list with all events that Gimp can
  69. recognize. Scroll to the event that you want to assign an action to and
  70. doubleclick its entry. Then select an Action from the dialog that pops up and
  71. doubleclick its entry. Now this action gets invoked when the specific MIDI
  72. event happens.
  73.  
  74. Please note that some actions fit perfectly to some MIDI Events: Actions like
  75. "context-background-blue-set" can immediately use the numerical value provided
  76. by midi controller events.
  77.  
  78. Have fun.
  79.